home *** CD-ROM | disk | FTP | other *** search
-
- DCAT03.DOC
-
- March 8, 1988
-
- by John Deakin
- Compuserve User ID (PPN) 74015,1624
- Genie ID JDeakin
-
- Index
-
- A. Release to Public Domain
-
- B. Warning
-
- C. Quick Start
-
- D. Introduction
-
- E. Command Line Options
-
- 1. Disk to be cataloged
-
- 2. Disk, path & file name for master catalog
-
- 3. Letter Options
-
- U Upper or lower case catalog listing
-
- X Create cross-reference listing when done
-
- F Force new label on each disk
-
- F. Usage suggestions
-
- G. Credits
-
- H. Future upgrades
-
- I. Modification history
-
-
- A. Release to Public Domain
- =============================
- DCATxx.EXE and DCATxx.DOC are released to the public domain, without
- restrictions of any kind. The source code is not available.
-
-
- B. Warning
- ============
- WARNING!
-
- This program is capable of magnetically writing information on disks. I have
- tested it as carefully as I know how, and so have others, with no ill
- effects. However, as with any such program, please take a few basic
- precautions. Create a few floppy disks for test purposes, and back up your
- hard disk. Run CHKDSK and any other diagnostic programs you may have BEFORE
- you run DCAT, then again AFTER running DCAT and exercising its features,
- especially the re-label feature. Please don't let this warning "turn you
- off" on DCAT, I believe it should be common practice with ANY new program,
- commercial, shareware, or otherwise.
-
- It runs on my system with no problems that I can see, and has been tested
- under DOS 2.0. However, it may have other effects on other machines I don't
- know about yet. Once a few dozen people report using it without any problems
- (if that many ever run it), I'll be a lot more comfortable.
-
- I run a Toshiba T3100/20, which is an IBM-AT compatible machine, with DOS
- 3.2, Vcache, Sidekick, and about a dozen other TSR's.
-
-
- C. Quick Start
- ================
- Warning!
-
- (If you have been using DCAT02 or earlier beta test
- versions, you should (once more) erase and re-create
- your entire master catalog. Sorry.)
-
- Preferred usage is to place DCAT on your hard disk (usually C:), anywhere in
- your normal path, RENamed as you like (I use DC.EXE). Call up the program in
- the usual way, and you will be presented with some information, along with
- the prompt to insert a disk in drive A:. Just hit the <space> bar, and
- repeat for a few disks, then exit with <Esc>.
-
- Then, look in your root directory using any lister (Vern Buerg's LIST62A
- highly recommended (shareware, $15)), and you will find a two new files,
- named DCAT.CAT and DCAT.BAK. As you might suppose, DCAT.BAK will always
- contain the "previous version". DCAT.CAT will first list each disk label and
- space available, one per line. DCAT.CAT will then list each file found and
- disk label where found, one per line.
-
- Subsequent runs will update the catalog as you might expect.
-
-
- D. Introduction
- =================
- DCATxx (xx is the version number) is intended primarily as a program to
- catalog floppy disks, so that any given file may be found as quickly as
- possible from a bunch of floppies. It will also assist in "housekeeping" on
- such floppies, allowing the user to determine how many copies of a file
- exist, and where they are located. It is fast, simple, and convenient,
- without many of the "bells and whistles" of other MS-DOS programs. It will
- scan all sub-directories on the cataloged disk. It will maintain the master
- catalog in pure ASCII (upper or lower case) text, allowing the use of other
- programs and tricks with that catalog.
-
- The master catalog is maintained in one file, with two parts. The first part
- is a list of disks, with free space remaining, each on one line. The second
- part is a list of filenames, time/date, filesize, disk volume label, and sub-
- directory found, each file on one line, with its data.
-
- Example:
-
- VolumeLabel Space
- deakin020 491520 free
- main 6463488 free
- |- End disk listing -|
-
- Filename.Ext mm/dd/yy hh:mm:ss Size VolumeLabel Path\Path\...
- |----------| |------| |------||------| |---------| |--------------->
- abort.txt 02/05/88 18:08:28 15232 main \tap
- addendum 01/01/88 12:00:00 3265 main \pr
- datetest.c 11/01/87 23:17:36 959 main \turboc\source
- dc.bak 03/05/88 13:24:14 18380 main \turboc
- dc.c 03/05/88 01:01:42 18181 deakin020 \
- dc.c 03/05/88 13:37:44 16458 main \
- dc.c 03/04/88 15:26:12 17493 deakin020 \subdir1
- dc.c 03/04/88 15:26:12 17493 deakin020 \subdir1\subdir1a
- dc.c 03/05/88 13:37:44 16458 main \turboc
- dc.c 03/05/88 01:01:42 18181 main \turboc\source
- dc.exe 03/04/88 16:12:10 18974 deakin020 \
- dc.exe 03/04/88 16:12:10 18974 deakin020 \subdir1
- dc.exe 03/04/88 16:12:10 18974 deakin020 \subdir1\subdir1a
- dc.exe 03/05/88 13:37:58 19174 main \turboc
- dc.obj 03/04/88 16:12:08 10951 deakin020 \
- dc.obj 03/04/88 16:12:08 10951 deakin020 \subdir1
- dc.obj 03/04/88 16:12:08 10951 deakin020 \subdir1\subdir1a
- dc.obj 03/05/88 13:37:56 11215 main \turboc
- dcat.arc 12/23/87 22:47:22 30027 main \turboc\source
- dcat.asm 09/26/87 23:34:04 3200 main \optasm
- dcat.bak 03/05/88 01:56:42 6230 main \
- z80asm.com 07/01/87 23:05:48 22528 main \z80cpm
- z80mu.exe 12/08/85 17:00:00 96518 main \z80cpm
- zaptap.inf 01/01/88 01:01:00 5632 main \tap
-
-
- Note the file is maintained in FILENAME.EXT order first,
- SUB-DIRECTORY order second, and
- VOLUME LABEL order third.
-
- This may appear a bit odd at first, as you might think it should appear in
- the displayed order, left to right. However, if I put the sub-dir information
- in the second column where you might expect it, that column would either have
- to be 80 characters wide to accommodate the longest possible path name, OR the
- columns would be "ragged", which would be most undesirable.
-
- When DCAT loads, it determines the amount of memory available to it, and
- determines (and tells you) how many files per disk it can handle. My system
- has about 430,000 bytes of RAM free after all my TSR's are loaded, and this
- allows just over 8,000 files per disk (absolute maximum is 32,000). The size
- of the master catalog is limited only by disk space.
-
-
- E. Command Line Options
- =========================
- For those wishing to use DCAT in a different way, there are several command
- line options. If you elect to use these, I suggest you either set up a BAT
- (Batch) file to do it the same way, every time, or even better, a CED (or
- PCED) SYNonym. (CED is public domain, PCED is a commercial product, both by
- Chris Dunford, Cove Software Group.)
-
- If you do use options, and try to remember them, you will almost certainly
- end up with different catalog files scattered all over the place, possibly
- with information from an unintended disk. There is no way to "merge" such
- files.
-
- Command line options may be entered in any order, or omitted. They must be
- separated by one or more spaces. DCAT scans the command line, checking the
- syntax of each "group of characters" for proper matches. A quick example of
- a full-blown command line:
-
- C: > dcat a: -c:\misc\catalog ufx
- ^^^^ ^^ ^^^^^^^^^^^^^^^^ ^^^
- |||| || |||||||||||||||| |||
- |||| || |||||||||||||||| +++-- Letter options
- |||| || |||||||||+++++++------ Catalog name
- |||| || ||||++++-------------- Sub-dir name
- |||| || +++------------------- Drive specification
- |||| ++----------------------- Catalog this disk
- ++++-------------------------- Program name
-
- The following command line would produce exactly the same result:
-
- C: > dcat xfu -c:\misc\catalog a:
-
- 1. Disk to be cataloged
- =========================
- This command line parameter tells DCAT where to find the disk to be
- added to the catalog, and must consist of a letter, A through F (upper
- or lower case), followed immediately by a colon, in the usual MS-DOS
- manner. Valid examples:
-
- C:> DCAT A: <-- normal usage
- C:> DCAT C: <-- can do this, from root only
- C:> dcat f: <-- lower case ok, too
-
- 2. Disk, path & file name for master catalog
- ==============================================
-
- (Note: Previous versions required the "backslash" to
- identify the disk and sub-directory where the catalog
- file is to be placed. This has been changed to the
- leading "-" (minus).
-
- This command line parameter tells DCAT where to place the master
- catalog. The user can specify a disk drive, a path, and a filename. It
- must have a leading "minus" (-) in order for DCAT to recognize the
- command. That leading minus will NOT be used as part of the filename.
- Valid examples:
-
- C:> dcat -\catalog
-
- This would force the filename to be CATALOG.CAT(the
- ".cat" extent is added automatically), into the root
- directory of the C: drive.
-
- C:> dcat -catalog
-
- Careful! This means put it in the "current sub-
- directory", from wherever you happen to call DCAT.
-
- C:> dcat -d:\subdir1\subdir2\catalog
-
- This would put CATALOG.CAT on drive D:, with the path
-
- \subdir1\subdir2
-
- 3. Letter Options
- ===================
- If DCAT finds a command line group that does NOT match the syntax for
- the first two described above, it assumes you are specifying one of the
- command line option letters U, F, or X, described here. Superfluous
- letters are simply ignored.
-
- Valid examples:
-
- C:> dcat u <-- all upper case,
- C:> dcat uf <-- and ask for new labels,
- C:> dcat ufx <-- and make a cross-reference file.
-
- (U) Upper or lower case catalog listing
-
- DCAT defaults to keep the master catalog in all lower case. If you
- prefer, you may use this option to force all upper case. If you
- decide you want "the other case", just re-catalog one floppy with
- or without the U option letter, and the entire catalog will be re-
- written. The ORDER is always as if all alpha characters are
- actually in upper case, regardless of the case chosen for the
- catalog. This is necessary to handle filenames or labels with odd,
- non-alpha characters.
-
- (X) Create cross-reference listing when done
-
- Disabled function, at this writing.
-
- (F) Force new label query on each disk
-
- This option tells DCAT to stop on every single disk and ask for a
- new volume label, even if there is already one on the disk. A
- simple <cr> will tell DCAT the existing label should be kept. This
- is of benefit to the initial setup of your master catalog, and
- later when adding a group of new disks. Note that if there is no
- volume label at all on the disk, DCAT will automatically prompt for
- a label, regardless of how it was called, and will not continue
- until a valid label is entered and written to the disk. Note this
- may create a problem if you have a factory master you wish to
- catalog, with no volume label, and write-protected. It will be
- necessary to "un-protect" it long enough to write a volume label,
- either with DCAT, or some other program. A better procedure is to
- make a copy of that master, add a volume label, and catalog that.
-
-
- F. Usage suggestions
- ======================
- In some ways, DCAT will allow you to do things in a much less organized
- manner, while keeping you better organized. However, to do this, it is
- necessary to do a little organization first!
-
- Let us consider the manner in which most folks organize their floppies
- without a cataloging program. Most seem to gravitate towards sticking a
- paper label on the disk jacket, with a general title or comment as to what
- type of programs are on that disk. If you program in BASIC, you might have
- one labeled "Working BASIC programs", another "BASIC data files", etc. I
- find this terribly wasteful of disk space, as one seldom-used disk might go
- for months with only a few files, while you might have to have three or four
- (or more) "Word-Processing Data Files" disks, some full, some not, perhaps
- with some loose grouping. Labels are difficult or impossible to peel off,
- and end up a mess, eventually having little relationship to the contents of
- the disk.
-
- Think about the way MS-DOS handles files. You certainly don't care if a text
- file gets put on a track right next to a program, you let DOS take care of
- all those details. Why not treat your collection of floppies in a similar
- manner? Whether you have 20, or 200, why not treat the whole bunch as just
- one big "blob" of data, and let an easier system take care of the dirty
- details? I realize this will be a radical idea to many, and can hear the
- howls now "but I've ALWAYS kept my <whatever> files on a separate disk!"
- DCAT can help you there, too, but I think there's a better way.
-
- For any effective use of DCAT, you will need to develop and use a reasonably
- systematic method of labeling disks, with the magnetic volume label also
- clearly displayed on the disk jacket. A simple system of four digit numbers,
- like "0001", "0002", etc. will do nicely, and means you'll NEVER have to re-
- label disks again.
-
- Warning!
-
- DON'T write MAGNETIC volume labels as "1,2,....9,10,11,12",
- however! That would sort as:
-
- 1
- 11
- 12
- 2
- 3
-
- which most folks would consider undesirable. There's nothing wrong with
- putting "1" on the PAPER label of disk "0001", of course.
-
- However, DCAT permits any volume label, so it's up to you. There MUST be
- some way to relate the volume label to the physical disk. It doesn't do you
- much good to have a volume label of PA2342SLT, and have the Toshiba factory
- paper label say only "Master System Disk". With that, you've got to remember
- what it means, and that's a bummer.
-
- I suggest you fool around with DCAT a little bit, see how it works, then give
- some thought to a systematic way of labeling your disks in some manner that
- provides a direct mental connection between the paper label and the magnetic
- volume label written into the disk directory. This is a crucial, absolute
- requirement!
-
- DCAT may be copied to any drive, any subdirectory, and renamed as needed. I
- run it from my \ms subdir, where all my system files and utilities are
- located, and I call it DC.EXE.
-
- Note there is a command line option for (F)orce, and also a (F)orce option
- while actually running DCAT. If you use the command line option, DCAT will
- automatically stop and ask for a new label on each disk. If you are in the
- midst of a cataloging operation, did not specify the "F" option, and realize
- you wish to re-label just one disk, you may hit "F" instead of <space>, and
- DCAT will prompt you for a new label for just that disk.
-
- (Of minor interest is that ANY key will make DCAT "go", not just the space
- bar and the "F" key.)
-
- Unlike previous programs under CP/M, DCAT does not require the creation of a
- zero-length file with special characters. Instead, it uses the capability
- under MS-DOS to have a "volume label" written magnetically on the disk. Any
- legal characters for a volume label may be used, and no special characters
- are required.
-
- WARNING: A volume label is ALWAYS required.
-
- Volume labels should be unique, or all files on multiple disks will be listed
- under the same volume label, sort of defeating the purpose of DCAT.
-
- The first time DCAT is run, it will create its own datafile, as needed. You
- can, if you wish, have several catalog data files, in different sub-
- directories, or with different names, although that's likely to get confusing,
- if overdone. The master catalog and the backup file are closed and updated
- after every single disk. During operation, the catalog data file is read,
- left unchanged and a scratch file is created. Only upon successful close of
- that file does the previous data file get written to <filename>.BAK, and the
- scratch file RENamed to <filename>.CAT. As a result, you will normally have
- the current catalog, and its predecessor when DCAT is done, normally named
- DCAT.CAT and DCAT.BAK. Even a power failure at the most critical moment will
- leave a good catalog, either in <catfile>.CAT or <catfile>.BAK.
-
- These are pure ASCII text files, and can be looked at with any editor. Be
- VERY careful about editing, as the program expects to find certain things
- like spacing, format, separator lines, etc. Any MANUAL edit that alters
- order, spacing, or virtually anything about the file will corrupt it, and
- subsequent catalog operations by DCAT will only increase the errors. Once
- corrupted, the file cannot be recovered. I STRONGLY suggest you ONLY delete
- whole lines if you edit the file, and DO NOT delete or alter the lines like:
-
-
- VolumeLabel Space
- |- End disk listing -|
- <- not even this blank line!
- Filename.Ext mm/dd/yy hh:mm:ss Size VolumeLabel Path\Path\...
- |----------| |------| |------||------| |---------| |--------------->
-
-
- It is much safer use a "lister" program that cannot alter the file, and let
- DCAT itself do all the alterations. DCAT was designed to be used with Vern
- Buerg's superb LIST62a program, available as shareware ($15). That program
- will allow you to scan the list, look for specific text, and find whatever you
- need, using the (F)ind and (A)gain commands. There are others that will do
- the job, but I know of none so nice. It is one of the most heavily used
- programs on my own system.
-
- Note the columnar layout of the catalog file. If you wish, it is suitable
- for a variety of purposes. It can be sorted in many different ways, for
- example, by disk volume label. To do this, COPY the catalog file (normally
- DCAT.CAT) to a file with another name, use any editor to "clip" the first
- section out, then sort on column 40 (with left-most column being 1). With
- similar modest effort, the catalog file might be loaded into a dBASE DBF
- file, or some other data-base program's data format.
-
- On my system, I also have a SYNonym called "cat" which looks like:
-
- ced syn cat "list \dcat.cat"
-
- With this, from any DOS prompt, anywhere in the system, I can just type
- "cat<cr>", and look at my master catalog of disks. The same effect can be
- had with a BAT file, of course. You'd create a text file called CAT.BAT in
- your normal path, with the following line:
-
- list \dcat.cat
-
- There is currently no easy way totally to delete an entire disk from the
- master catalog. In my opinion, this will rarely be required, because even
- though you delete all files from a disk, you still want the disk listed in the
- catalog file, showing it as having maximum "Space Free". If you must totally
- delete it, the easiest way to do so is to erase all files from the disk you
- wish to delete, run DCAT on it to remove all the files from the catalog, then
- simply edit the catalog file to remove the one line that contains the volume
- label and free space remaining. Alternatively, a macro editor could be used
- to search out all occurrences of the volume label and delete any line on which
- it is found, but that could also delete a filename containing the same
- characters, if you're not careful.
-
- If you want to delete a volume from the catalog, and you do not wish to
- delete all files from the disk in order to run DCAT on it, you can also
- temporarily label a blank disk with the same name, and run DCAT on that.
-
- Ok, let's assume you have DCATxx.ARC, DCAT.EXE, and DCAT.DOC in your current
- directory as you read this, and you have temporarily labeled a few disks with
- masking tape, and "0001", "0002", etc., and cataloged them, just for fun. You
- think you'd like to archive just DCATxx.ARC, and wonder which disk has enough
- space. Check the size of DCATxx.ARC, then look at the catalog's first
- section, scan down until you find a disk with "just enough" space, grab that
- disk by number (absolutely uncaring what else might be on it), copy DCATxx.ARC
- to it, call up DCAT, hit <space> <esc>, and you're DONE. The file is archived
- and cataloged in less time than it took you to read this paragraph!
-
- (A side benefit is that using DCAT in the suggested manner will lead to much
- more effecient usage of your floppy disks, with most of them having only a
- little space remaining, then a few with increasing space, followed by all the
- rest with maximum space free.)
-
- Having done that, you delete the ARC file from your hard disk, but find you'd
- like to pass DCAT along to a friend, in the original ARC file. You call up
- your catalog with LIST62A, use the <F>ind command on "dc", then <A>gain until
- you come to DCATxx.ARC. Looking on that line, you see it is on disk 0018, and
- in what subdirectory (if you use them on floppies, I don't). Grab the disk
- with "0018" (or "18") on the jacket, and you've got it, right now.
-
- Now let's say you're one of my long-suffering beta testers, and you've got
- "dc*.*" files all over the place, just like I do. Call up LIST DCAT.CAT
- again, <F>ind "dc", and take a look. Fish out all the floppies with
- "dc<anything>" on them, DEL DC*.*, and you KNOW you're starting "clean". (Of
- course, you then have the option of DELeting all these LATEST files,
- forgetting you ever heard of DCAT, and REALLY "starting clean"!)
-
- DCAT scans the floppy very quickly, and the moment that scan is done, you are
- free to remove that floppy and insert the next one, even if DCAT is still
- writing the new or updated information to the catalog file. A bell and prompt
- tells you exactly when you can do this, and with a little practice, you'll be
- able to catalog floppy disks just as fast as you can stuff 'em in the drive.
-
- (Of course, DON'T try this during the really strange case of writing the
- catalog datafile on the same floppy being cataloged!).
-
- G. Credits
- ============
- DCAT is 100% original coding in Turbo C from scratch, by me, except for a few
- lines by Dennis Vallianos in the disk volume re-labeling function.
-
- However, I would be less than honest if I did not give credit to the people
- and programs which led up to it.
-
- According to Ward Christensen, "sometime in the late 1970's", he wrote a CP/M
- program he called FMAP that would, among other things, produce a sorted
- directory to a disk file. From this was born the idea of a "master" catalog
- program. Since CP/M had no provision for volume labels, Ward also had the
- idea of creating a zero-length file under CP/M, with the initial character
- "-", so that it would sort to the top of the list. FMAP created the list,
- UCAT updated it, and CAT was for searching the list. Ward remembers writing,
- but probably did not release a program he called KAT, which could do a much
- faster binary search on initial characters.
-
- According to much later documentation in an MS-DOS variant (NCAT), in early
- 1980, Lewis Moseley, Jr. wrote a program combining these functions, and
- called it NEWCAT.
-
- Irv Hoff remembers "some fellow in a trailer camp near Georgia" working on
- this program, and that he thinks it was called NCAT at the time. That may,
- or may not have been Moseley.
-
- Irv then took the program, cleaned it up, made it more automatic, made it
- capable of handling any number of sorted filenames, and renamed it MCAT,
- eventually ending up with MCAT45, which remains, in my opinion, the classic
- disk catalog program for CP/M-80.
-
- In about 1982, Dennis Vallianos translated NEWCAT into 8088 assembler
- language, and called that NCAT. The one problem with that program was that
- it did not create a list of disks, with free space remaining on each, a
- critical need, in my opinion.
-
- On April 7, 1984, Peter A. Polansky, of Dolgeville NY, took the source code
- from Irv's MCAT, and translated it to CP/M-86, calling it MCAT86-1. It did
- not produce a list of disks and free space either.
-
- I was quite distressed at the huge size, clumsiness, and "rampant featuritis"
- I found in the other disk catalog programs in the DOS world, so decided to
- "roll my own", with only the options I wanted. I have named it DCAT, for
- "Disk CATaloger". I started in assembler, but about that time, Borland came
- out with the superb Turbo C compiler, so I decided to use that, learning a
- little about C in the process. (Wow, did I ever!)
-
- My deepest thanks:
-
- To Ward Christensen 76703,302, who started it all.
-
- To Irv Hoff 76701,117, whose efforts in CP/M public domain programming are a
- legend, and an inspiration to us all. DCAT is patterned very closely after
- MCAT45, although I have never seen the source code for that program.
-
- To Dennis Vallianos 70406,1163 for his assistance these many years, on a
- variety of computer-related matters, for his encouragement, for his pushing
- me to try Turbo C, and for specific advice and comments on DCAT. I have
- cursed him (under my breath) as much as I have praised him publicly, but I've
- learned a good deal as a result of his efforts, and in spite of my own
- limitations.
-
- To Bill Snyder 70425,115 and Phil Tobias 74055,530 for encouragement,
- testing, suggestions and assistance.
-
- To Mike Rubenstien and Pete Becker on Borland's BPROGB for several very
- helpful messages getting me over a number of humps in learning a little about
- Turbo C.
-
- H. Future Upgrades
- ====================
- You'll note the (X) "Cross-reference" command is disabled. I have not yet
- decided exactly how to present the information, user input is requested for
- "the next version", please. I know how to do it, I just can't think of any
- satisfactory method of displaying the information. About the best I can think
- of at the moment is:
-
- dc.c 03/05/88 01:01:42 18181 deakin020 \
- 03/05/88 13:37:44 16458 main \
- 03/04/88 15:26:12 17493 deakin020 \subdir1
- 03/04/88 15:26:12 17493 deakin020 \subdir1\subdir1a
- 03/05/88 13:37:44 16458 main \turboc
- 03/05/88 01:01:42 18181 main \turboc\source
- dc.exe 03/04/88 16:12:10 18974 deakin020 \
- 03/04/88 16:12:10 18974 deakin020 \subdir1
- 03/04/88 16:12:10 18974 deakin020 \subdir1\subdir1a
- 03/05/88 13:37:58 19174 main \turboc
- 03/04/88 16:12:08 10951 deakin020 \
- dc.obj 03/04/88 16:12:08 10951 deakin020 \subdir1
- 03/04/88 16:12:08 10951 deakin020 \subdir1\subdir1a
- 03/05/88 13:37:56 11215 main \turboc
-
-
- I am considering further command line options to make DCAT do a sort on other
- fields, producing a separate file of results. User input requested. Again, I
- know how to program it, I just don't need any other formats myself, and have
- no idea what you might have in mind.
-
-
- I. Modification history
- =========================
-
-
- March 8, 1988 DCAT03 John Deakin
- =================================
- Added a blank line to separate the two portion of the catalog file.
-
- Total re-write and cleanup of the source code, many functions re-done.
-
- Added progress reporting to say "Rev: " on files with the same name, same
- sub-dir and same volume, but with a different time/date. Previous versions
- said "Del: ", then "Add: ", which was a bit disconcerting.
-
- Totally re-wrote sort and merge routines.
-
- Converted from Tiny memory model to Compact.
-
- Finally! Added full date, time, size and sub-directory information to
- catalog file.
-
- Minor cleanup of opening screen, on catalog file display.
-
- Added progress reporting during catalog operation, will delete this in future
- versions, as I gain confidence that it is not bombing any systems.
-
- Fixed problem where if DCAT was invoked from a subdirectory, and told to
- catalog the same disk from which invoked, it would start in the current sub-
- directory and work "down" only. It will now ALWAYS catalog from the root
- directory of ANY drive, and will end up back on the drive, and in the sub-
- directory from which invoked. (Unless interrupted with ^C, in which case it
- will end up logged onto whatever drive, and in whatever sub-dir was being
- cataloged when halted.)
-
- Changed command line syntax, to use the more familiar "minus" sign to
- identify the disk/drive/path of the catalog file, instead of the visually
- confusing backslash or worse, the double backslash. Should have been this
- way from the start.
-
- Changed memory allocations and compiler options so that uninitialized
- pointers do not take up space in the EXE file. Added code to determine
- maximum number of disk files per disk.
-
- Cleaned up the logic in the merge_label area, reducing file size a little.
-
- Changed all internal operation to work with all upper case at all times. If
- U option is NOT selected, conversion to lower case is done only just before
- output to the screen or to the catalog file. This results in exactly the
- same file order regardless of case, and also allows changing case of the
- entire catalog file.
-
- Fixed bug introduced in DCAT02, if no label on disk, a <cr> is entered at the
- label prompt, then <esc> was hit, disk was cataloged under a blank label.
-
-
- February 10, 1988 DCAT02 John Deakin
- =====================================
- Fixed bug causing master catalog corruption if any of the five characters ( [
- ] ^ \ _ ) between the upper and lower case ASCII set are used in filenames or
- disk labels.
-
- Increase maximum files per cataloged disk to 10000 from 1000, which was used
- during development and forgotten.
-
- Added error trapping to detect more than 10000 files per disk.
-
- Complete re-write of this DOC file.
-
-
- February 4, 1988 DCAT01 First full release. John Deakin
- ==========================================================
- Calling this one DCAT01, removing all restrictions, releasing to public
- domain.
-
- Added subdirectory traversal, will now catalog every file, in every
- subdirectory, using recursion. When a file is in two or more subdirectories
- on the same disk, it will show up as two entries in the master catalog, and
- in the cross-reference.
-
- Fixed bug that added trailing spaces to master catalog entries.
-
- Completely re-did logic (again) for merging directory entries with catalog
- entries.
-
-
- January 1, 1988 (approximate date) Fifth release. John Deakin
- ===============================================================
- Cleaned up disk volume re-labeling routines, with assistance from Dennis
- Vallianos. No more deleting, so DOS 2.0 block removed.
-
- Cleaned up command line parsing, parameters can now be entered in any order,
- with minimum key strokes.
-
- Cleaned up logic of merging labels, merging files.
-
- Converted to listing free space fully (730112 vs. 713k).
-
-
- December 24, 1987 Fourth release, beta test version. John Deakin
- ===================================================================
- Attempted to fix bug causing crash on some systems with a label on the
- catalog disk a full 11 characters long. Unable to duplicate the error on my
- own system, but did find a possible cause.
-
-
- December 23, 1987 Third release, beta test version. John Deakin
- ===================================================================
- Fixed bug that caused all cataloging to actually be done on A drive, even
- though another drive specified on command line.
-
-
- December 21, 1987 Second release, beta test version. John Deakin
- ===================================================================
- Fixed bug causing duplicate files in catalog, caused by a filename with one
- character.
-
- Fixed volume label routines to accept labels with spaces.
-
- General code cleanup, improved prompting, improved user interface.
-
- Added (F)orce capability to re-label a disk with a label already on it.
-
- Added several command line options:
-
- o Added capability to specify disk drive to catalog (A thru F), with
- default remaining A: drive.
-
- o Added capability to specify data file name, as well as the disk and
- directory to put it on/in. Default remains C:\DCAT.CAT.
-
- o (F)orce re-labeling ALL disks.
-
- o Make data files (U)pper case (default is lower case)
-
- o Create an additional (X) cross-reference listing.
-
-
- December 13, 1987 First release, alpha test version. John Deakin
- ===================================================================
-
- End of DCAT03.DOC
- ----------------end-of-author's-documentation---------------
-
- Software Library Information:
-
- This disk copy provided as a service of
-
- The Public (Software) Library
-
- We are not the authors of this program, nor are we associated
- with the author in any way other than as a distributor of the
- program in accordance with the author's terms of distribution.
-
- Please direct shareware payments and specific questions about
- this program to the author of the program, whose name appears
- elsewhere in this documentation. If you have trouble getting
- in touch with the author, we will do whatever we can to help
- you with your questions. All programs have been tested and do
- run. To report problems, please use the form that is in the
- file PROBLEM.DOC on many of our disks or in other written for-
- mat with screen printouts, if possible. The P(s)L cannot de-
- bug programs over the telephone.
-
- Disks in the P(s)L are updated monthly, so if you did not get
- this disk directly from the P(s)L, you should be aware that
- the files in this set may no longer be the current versions.
-
- For a copy of the latest monthly software library newsletter
- and a list of the 1,000+ disks in the library, call or write
-
- The Public (Software) Library
- P.O.Box 35705 - F
- Houston, TX 77235-5705
- (713) 721-6104 or (713) 721-5205
-